Color Computer 2 
MICRO- 
COMPUTER 




Start-Up 



1. Turn the television set ON. 

2. Select channel 3 or 4. 

3. Set the Antenna Switch to "COMPUTER." 

4. Turn on any accessory equipment (e.g., a printer). 

5. If you're using a Program Pak " , insert it now, before turning on 
the Computer. 

6. Turn the Computer ON. 

7. If you're not using a Program Pak", the Color BASIC or 
Extended Color BASIC start-up message will appear on the TV. 
followed by: OK 

The Computer is now ready to use. 

Note: Information pertaining to Extended Color BASIC only is 
shaded like this paragraph. Non-shaded information pertains to 
both Extended and non-Extended Color BASIC. 
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Video Control Codes 



Dec Hex PRINT CHR$ (code) 

8 08 Backspaces and erases current character. 

13 0D Line feed with carriage return. 

32 20 Space 



Operators 

Each operator or group of operators is 
precedent over the group below it. 



-,+ 
V 

+ .- 



Exponentiation 

Unary negative, positive 

Multiplication, division 

Addition and concatenation, subtraction 



<,>, = ,<=,> = ,<> Relational tests 

NOT 

AND 

OR 



Graphic Character Codes 

Given the color (1-8) and the pattern (0-15), this formula wil 
generate the correct code: 

code = 128 + 16 • (co/or-1) +- pattern 

I 1 1 'I -I •■ 
'I '■ *■¥"■"■ 



12 



■ ■HI 



For example, to print pattern 9 in blue (code 3). type: 
C = 1Z8+ IB* (3-1) +9 
? CHR$ (C) 



• 



Functions 



Argument ranges are indicated by special symbols. 

numeric: (-10 38 , + 10 38 ) 

x: (0-255) 

y: (0-191) 

location: (0-65535) 

code: (0-255) 

Str. string argument 

var: variable name 

ABS (numeric) Computes absolute value. 
Y=ABS<5) 

ASC (str) Returns ASCII code of first character of specified 
string. 
A=ASC(T«) 

(numeric) 

Y=ATN<X/3! 

CHR$ (code) Returns character for ASCII, control, or graphics 
code. 

?CHR*( 191 ) 
P*=CHR$(T) 

COS (numeric) Returns cosine of an angle given in radians. 

EOF (f) Returns FALSE (0) if there is more data, TRUE(-1 ) if 
end of file has been read. For cassette. / = - 1 : for keyboard. 
/ = 0. 
E0F=( -1 ) 

E F ' fl 

EXP (numeric) Returns natural exponential of number 

(e 



V =EXP(7) 



lumber 
it) value. 



FIX (numeric) Returns truncated (whole number) 

Y = F I X ( 7 . G > 

HEX$ (numeric) Computes hexadecimal value. 
PRINT HEX* (30) 

Y =HEX* (X/1B) 

INKEYS Checks the keyboard and returns the key being 
pressed (if any). 
A*=INKEY* 

INT (numeric) Converts a number to an integer. 

X = I N T ( 5 . Z ) 



OLOR BASI 



JOYSTK 0) Returns the horizontal or vertical coordinate (/') of 
the left or right joystick: 

= horizontal, left joystick 

1 = vertical, left joystick 

2 = horizontal, right joystick 

3 = vertical, right joystick 
M=JOYSTK (0) 

H = J0YSTMk ) 



LEFTS (str.length) 

string. 

P$=LEFT$ (M* .7 



Returns left portion [length characters) of 



LEN (str) Returns the length of a string. 
;: = LEN(SEN$ ) 



LOG (numeric) 

y = L OG ( 353 ) 



Returns natural logarithm 




MEM Finds the amount of free memory. 
PRINT MEM 

MID$ (str. pos. length) Returns a substring of another string 
starting atpos. If length is omitted, the entire string right of 
position is returned 
F$=MID$( A$ .3) 
?MID*< A* .3.1' 

PEEK (location) Returns the contents of specified memory 
location. 
>=PEEK<32076) 

POINT (x,v) Tests whether specified graphics cell is on or off, x 
(horizontal) = 0-63; y (vertical) = 0-31 . The value returned is -1 if 
the cell is in a text character; mode; if it is off. or the color code if 
it is on. See CLS for color codes. 

IFPOINT (10.10) THENPRINT "ON " ELSE PR I NT 
"OFF" 

POS (device) Returns current print position. Device- 1 
printer.-2 = display. 
PRINT TAB(8) POS(0 ) 

PPOINT (x.y) Tests whether specified graphics cell is on or off 
and returns color code of specified cell. 
PPOINT ( 13 .35.' 

RIGHTS (str.length) Returns right portion of string. 
ZIP$=RIGHT*(AD* .5) 

SGN (numeric) Returns sign of specified numeric expression: 
-1 if argument is negative 

if argument is 
+ 1 if argument is positive 
)< = SGN( A#B) 

SIN (numeric) Returns sine of angle given in radians. 
V = S I N ( 5 ) 



C and EXTE 




STRINGS (length. code or string) Returns: 

characters (of specified length) specified by ASCI! code or by the 
first character of the string. 
? STRING* (5 >" ■: 
?STRING*<5 ,31 ) 

STR$ (numeric) Converts a numeric expression to a string. 
S$=STR$ 

SQR (numeric) Returns the square root of a number. 
Y-BQR<S 

TAN (numeric) Returns tangent of angle given in radians. 
. .7) 

TIMER Returns contents or allows setting of timer (0-65535) 
? TIMER 

TIMER=0 

USRn (numeric) Calls user's machine-language subroutine. 
X = U S R i 

VAL (str) Converts a string to a number. 
A = <.'AL ( B$ ) 

VARPTR (var) Returns address of pointer to the specified 
variable. 
Y=USR( VARPTR <K> ) 



Control Keys 



(SHIFT @ 


BREAK 


CLEAR 


ENTER 


(SPACEBAR 1 


(SHIFT) BEr] 




(SHIFT' ( e 



Cancels last character 

typed; moves cursor back one space. 

Erases current line. 

Interrupts anything in progress and 
returns to command level. 

Clears the screen. 

Signifies end of current line. 

Enters a space (blank) character and 
moves cursor one space forward. 

Causes currently executing program to 
pause (press any key to continue). 

All-caps upper-lowercase 
keyboard switch. (Lowercase 
displayed as reversed capitals.) 
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Special Characters 

Abbreviation for REM. 
$ Makes variable string type. 
: Separates statements on the same line. 

? Same as PRINT. 
, PRINT punctuation: spaces over 

to the next 16-column PRINT zone. 
; PRINT punctuation: separates items in a 

PRINT list but does not add spaces 

when they are output. 



Error Messages 



Abbreviation 


Explanation 


fZ 


Division by 


At) 


File already OPEN 


BS 


Subscript out of range 


L.N 


Can't continue 


DD 


Redimensioned array 


DN 


Device number error 


DS 


Direct statement in file 


FC 


Illegal function call 


FD 


Bad file data 


FM 


Bad file mode 


ID 


Illegal direct 


IE 


Input past end of file 


I/O 


Input/Output error 


LS 


String too long 


MF 


NEXT without FOR 


NO 


File not open 


DD 


Out of data 


- M 


Out of memory 


DS 


Out of string space 


DV 


Overflow 


RG 


RETURN without GOSUB 


SN 


Syntax error 


SI 


String formula too complex 


TM 


Type mismatch 


Ul 


Undefined line 



I 



:i 



Statements 



AUDIO Connects or disconnects cassette output to TV 
speaker. 
AUDIOON 
AUDIOQFF 

CIRCLE (x.y).r.c.hw.start.end Draws a circle with center at 
point (x,y) radius r, specified color c. height width ratio {hw) of 
0-4. Circle can start and end at specified point (0- 1 ). 
CIRCLE < 128 .96) .50 .4 ,1 -.5 ..75 

CLEAR n.h Reserves n bytes of string storage space. Erases 
variables, h specifies highest BASIC address. 

CLEAR 

CLEAR 500 

CLEAR 100 . 14000 

CLOAD Loads specified program file from cassette. If file name 
is not specified, first file encountered is loaded. File name must 
be eight character spaces or fewer. 
CLOAD 
CLOAD "PROGRAM" 

CLOADM Loads machine-language program from cassette. 
An offset address to add the loading address may be specifiec 
CLOADM "PROG" 
CLOADM 
CLOADM "PROG" . 1000 




CLOSE d 


Closes open files. 


CLOSE 




CL0SE- 


-i 


CLS c Clears display to specified colore. If color is not 


specified 


green is used. 


0-Black 




1 -Green 


5-Buff 


2-Yellow 


6-Cyan 


3-Blue 


7-Magenta 


4-Red 


8-Orange 


CLS 




CLS3 





COLOR (foreground, background) Sets foreground 
and background color. 
COLOR, 1 ,3 

CONT Continues program execution after pressing ( BREAK ) or 
using STOP statement. 
CONT 

CSAVE Saves program on cassette (program name must be 
eight character/spaces or less). If A is specified, program saved 
is ASCII format. 
CSAVE "PROGRAM" 
CSAVE "PROGRAM" ,A 



0. 



Writes out a 




CSAVEM name, start, end, transfer 

machine-language file. 
CSAVEM "X" -4E .GF ,5F 

DATA Stores data in your program Use READ to assign this 
data to variables. 
DATA5 .3 -PEARS 
DATA PAPER . PEN 

DEF FN Defines numeric function 
DEFFNI X)=X* 3 

DEFUSR n Defines entry point for USR function n . n = 0-9. 
DEFUSR5=45643 

DEL Deletes program lines. 
DEL- 
DEL 25 
DEL 

DEL -25 
DEL 1(3-25 

DIM Dimensions one or more arrays. 
DIM R(B5 ) >W< 40 ) 
DIMAR$(8 ,25) 

Loads BASIC program at specified baud. 




DLOAD 

baud. 

= 300 baud 

DLOAD "X" . 



1 = 1200 baud 






DRAW Draws a line beginning at specified starting point of 
specified length of specified color. Will also draw to scale, draw 
blank lines, draw non-updated lines, and execute substrings If 
starting point is not specified, last DRAW position or ( 1 28,96) is 
used. 
DRAW "BM 100 i 1005S105U25 5BR25 5NDZ5 JXAt 5 

EDIT Allows editing of program line. 
nC Changes n number of characters. 
nD Deletes n number of characters. 
I Allows insertion of new characters. 
H Deletes rest of line and allows insert. 
L Lists current line and continues edit. 
nSc Searches for nth occurrence of character c 
X E xtends line. 

S HIFT; f Escape from subcommand. 
nllPACEBAR Moves cursor n spaces to right, 
n & Moves cursor n spaces to left. 
EDIT 

END Ends program. 
END 

EXEC (address) Transfers control to machine-language 
programs at specified address. If address is omitted, control is 
transferred to address set in last CLOADM. 
EXEC 
EXEC 32453 




OR BASIC 



FOR..TO Creates a loop in program which the Computer must 
STEP/ repeat from the first number to the last number you specify. 
NEXT Use STEP to specify how much to increment the number 

each time through the loop. If you omit STEP, one is used. 

F0RX=2TQ5 :NEXTX 

FOR A=l TO 10STEP5 :NEXT A 

FORM = 30TO10STEP-5 : NEXT M 

GET (start) -(end), destination, G Reads the graphi 
contents of a rectangle into an array for future use by PUT. 
GET (5 #Z0)-<3 »81 »'.' -G 

GOSUB Calls a subroutine beginning at specified line number. 
GOSU8 500 

GOTO Jurros to specified line number. 
GOT'"' "0 



' 



ELSE action 1, action 2 Performs a test, 
nouter executes action 1 . If false, action 2 is 



/Omputer to stop and await input from the 



IFTES1 

IF it is. 

exeoji. 
IFA=51 

INPUT Causes 

keyboard. 

1 -'PUT V$ 

NAML N* 

1NPUT#-1 Inputs data from cassette. 
INPUT*-1 -A 

INSTR (position, search, target) Searches for the first 
occurrence of target string in search string beginning at position 
Returns the position at which the match is found 

? instr (5 .;•;$ <-<%) 

" K ' r *" ,igns value to variable (optional). 
LETA* = "JOB A" 

_ists specified line(s) or entire program on screen. 

f 

3T 50-B5 

IST30 

.1ST -30 

LIST30- 

iST List specified program line(s) or entire program to printer. 
LLIST 

LLIST 50-85 
LLIST 30 

LIST -30 

-IST30- 



LI.ME (xl,yl).(x2. v 2).PSET or PRESET. BF Draw a line 
from (x 1,y 7 ) to (x2,y2). If (x 1 ,y 1) is omitted, the last end point or 
( 1 28.96) is used. PSET selects foreground color and PRESET 
selects background color. ,B draws a box with (x 1.y 1 ) and 
(x2.y2) as the opposing corners. ,BF will fill in the box with 
foreground color. 
LINE (5-3)-(B.G) .PSET 



and E 



Replaces a portion of one 



LINE INPUT Input line from keyboard. 
LINE INPUT ANSWER" iX* 

MID$ (oldstr, position, length) 

string with another string 
MID$ <A$ .14 ,2>="KS" 

MOTOR Turns cassette ON or OFF. 
MOTOR ON 
MOTOR OFF 

NEW Erases everything in memory. 
NEW 

ON. . .GOSUB Multi-way branch to call specified suoioutines. 
ON Y GOSUB 5(3 . 100 

ON. . .GOTO Multi-way branch to spec ■ . lir 
ONXGOTO 190 .200 

OPEN m,#d,/ Opens file (Oat: Sere- -d(0): 

Cassette (-1 ): Printer (-2). For input J) 

OPEN "0" . - 1 . "DATA" 

PAINT (x.y).c.b Paints graphic sc. 
with specified color c and stopping a : 
color 
PAINT ( 10 ,10) .2 ,a 



PCLEAR n 

pages. 

PCLEAR 8 



i'/', ol specified 
Reserves n number of 1 .5 K graphics memory 



PCLS c Clears screen with specified colore. If color code is 
omitted, current background color is used. (See CLS for color 
codes.) 
PCLS 3 

PCOPY Copy graphics from source page to desti. 
PC0PY5T0E 

PLAY Plays music of specified note (A-G or 1 - 1 2), ocu 
volume (V), note-length (L), tempo (T), pause (P), and ai 
execution of substrings. Also sharps (# or • (and flats (- 
play "Li ;a«* ;p8 ;ui0 ;t3 ;l2 ;b- i 9 ; ) < a t ; " 



PMODE mode, start-page 

memory page. 

PMODE U -1 

POKE (location, value) 

memory location. 
POKE 15872 ,255 



Selects resolution and 



dfin. 



*#* 



Puts value (0-255) into spe' i.ieo 




PRESET Reset a point to background co 
PRESET (5 iE) 

PRINT Prints specified message or number on TV screen. 
PRINT "HI" 



DED COLOR 




PRINT#-1 Writes data to cassette. 
PRINT A* 

PRINT«-1 .A 

PRINT#-2 Prints an item or list of items on the printer. 
PRINTtt-2 .CAP* 

PRINT TAB Moves the cursor to specified column position. 
PRINTTAB(5) "NAME" 

PRINT USING Prints numbers in specified format 
Formats numbers. 
PR I NT USING "*««»" i B! 
Decimal point. 

PRINT USING "*#.«*" i 58. 6 
Displays comma to left of every third character 
print using "»»«*» ." ;aa . 
Fills leading spaces with asterisks. 
PR I NT USING "****.««" 5 33.3 
Places $ ahead of number. 
PRINT USING "$**.««" 533. 3 
Floating dollar sign. 

PRINT USING "$*»».«" I 1 i ,5aa 
Floating dollar sign. 

PR I NT USING "*«**. ##" ? 8.333 
In first position, causes sign to be printed. In last 

position, causes sign to be printed after the number. 
PRINT USING "+** . *" 5-21B 
Exponential format. 
PRINTUSING"**.»tttt" 554G 
Minus sign after negative numbers. 
PRINTUSING"««.«-" J-534.7 
Returns first string character. 

PRINTUSING ! "YELLOW" 

spaces% String field: length of field is number of spaces 
plus 2. 
PRINT USING""*: Z"i"BLUE" 



* T T * 



%spa< 



Prints specified message at specified text 



PRINT (a location 

screen location. 
PRINT 25G ."HI 
PRINT025G . A* 

PSET (x,y,c) Sets a specified point (x,y) to specified colore. If r 
is omitted, foreground is used. 
PSET(5 ,B .3) 



PUT (start)-(end), source, action Stores graphics from 
source onto start, end rectangle on the screen. (Array rectangle 
size must match GET rectangle size.) 
PUT (3 i2)-<5 .G) -U -PSET 

READ Reads the next item in DATA line and assigns it to 
specified variable. 
READ A$ 
READC »B 




REM Allows insertion of comment in program line. Everything 
after REM is ignored by Computer. 
REM THIS IS IGNORED 
Id 7 X$ :REM IGNORE 



" 



NUM newline, startline. increment 

renumbering. 

RENUM 1000 ,5 .100 



Allows program line 



RESET (x.y) Resets a point 
RESET ( Id .15) 



RESTORE Sets the Computer's pointer back to first item on the 
first DATA line. 
RESTORE 

RETURN Returns the Computer from subroutine to the BASIC 
word following GOSUB. 
RETURN 

RUN Executes a program. 
RUN 

SCREEN screen-type, color-set Selects either graphics (1) 

tor text (0) screen and color-set (0 or 1 ). 
SCREEN 1 ,1 

SET (x,y,c) Sets a dot at specified text screen location to 
specified color. 
SET( U .13.3) 

SKIPF Skips to next program on cassette tape, or to end of 
specified program. 
SKI PF" PROGRAM" 




SOUND tone, duration 

duration. 
SOUND 128 .3 



Sounds specified tone for specified 



STOP Stops execution of a program. 
STOP 

TROFF Turns off program tracer. 

TROFF 

TRON Turns on program tracer. 
TRON 
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Printed In the U.S. A 
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